home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / web / spiderweb / tools / excerpt / excerpt.doc < prev    next >
Text File  |  1988-07-21  |  1KB  |  32 lines
  1. excerpt allows you to extract pieces of a tex file generated by weave.
  2. Like the TeX macros, excerpt recognizes the following hierarchy of
  3. section names:
  4.                 In Text        In Contents
  5.     #*= major division    new page    Bold title
  6.     #*  ordinary section    new page    standard title
  7.     #*1 subsection        new page    indented
  8.     #*2 subsection        same page    indented
  9.     #*3 subsection        new page    double-indented
  10.     #*4 subsection        same page    double-indented
  11.  
  12. Each kind of section is said to ``contain'' all sections below it in
  13. the table.  Thus if you have a WEB file with a section called
  14. ``#*=Abstract Syntax.'', that section will contain all of the sections
  15. up to (and not including) the next #*=.  excerpt makes heavy use of
  16. containment.
  17.  
  18. If you type `excerpt vcgen', the program will go through a list of all
  19. of the sections in vcgen.tex, asking you whether you want to include
  20. each one.  You may reply `y' (yes), `n' (no), or `a' (all).  Or you
  21. may hit the carriage return and get the default (all).  The replies
  22. have the following meanings:
  23.  
  24.     y    include the section, and ask about contained subsections
  25.     n    omit this section, along with all the sections it contains
  26.     a    include this section and all the sections it contains
  27.  
  28. The output is written to `vcgen-excerpts.tex', and must be run through
  29. TeX and dvi in the usual way.  Of course you can use any name, not
  30. just vcgen.
  31.  
  32.